.TH stoker_local 5 "5 September 2008" "version 0.91" "Stoker Manual"
.SH NAME
stoker_local \- Stoker local machine source
.SH DESCRIPTION
Stoker can obtain machine and group information from a local file accessible
from the same host on which Stoker is executed.
Locally-defined machines and groups are enabled by setting the
machine_file directive in the Stoker configuration file stoker.conf(5).
.SH MACHINE FILE FORMAT
The format of the machine file is scf2(5), which specifies machines as
records and groups as lists.
A master list directive, \fBsearch_machine_definitions\fR, specifies all the
groups and machines that are to be loaded recursively.
For a machine to be able to be resolved to an IP address by Stoker, the
\fBprimary_ip\fR directive must be given for that machine.
Otherwise, Stoker relies upon operating system hostname resolution (by DNS,
LDAP, /etc/hosts, etc.).
Similarly, a \fBprimary_mac\fR MUST be specified for any machine that is to be
used with Wake-On-LAN.
.SH EXAMPLE
.nf
search_machine_definitions = [
   localhost
   otherhost
   group1
   group2
]

localhost = {
   primary_ip = 127.0.0.1
   primary_mac = 00:11:22:33:44:55
}

otherhost = {
   primary_ip = 192.168.0.1
}

group1 = [
   localhost
   otherhost
]

group2 = [
   another_host_to_be_included
]

another_host_to_be_included = {
   primary_ip = 192.168.0.2
}
.fi
.SH SEE ALSO
stoker.conf(5), scf2(5), stoker(8)
.SH AUTHOR
Mike Murphy <mamurph@cs.clemson.edu>
.SH DISCLAIMER
This material is based upon work supported under a National Science
Foundation Graduate Research Fellowship.
Any opinions, findings, conclusions or recommendations expressed in this
publication are those of the author(s) and do not necessarily reflect the
views of the National Science Foundation.
